home *** CD-ROM | disk | FTP | other *** search
/ Violence in 3D (Black Bird Entertainment) / Violence in 3D.iso / darkf / utils / dfuse091 / readme.1st < prev    next >
Encoding:
Text File  |  1995-05-05  |  5.9 KB  |  144 lines
  1.                            +====================+
  2.                            | DFUSE INSTALLATION | (package v 0.91)
  3.                            +====================+
  4.  
  5.           +---------------------------------------------------------+
  6.           | Dark Forces is (c) LucasArt Entertainment Company 1994  |
  7.           | DFUSE       is (c) Yves BORCKMANS 1995                  |
  8.           +---------------------------------------------------------+
  9.  
  10.  
  11. WELCOME TO DFUSE !
  12.  
  13. DFUSE (Dark Forces UtilitieS and Editor) is a collection of tools to design
  14. Dark Forces levels.
  15.  
  16. The main program DFUSE is in fact a "shell" around the following utilities:
  17.  - GOB file extractors (file by file, or all the .GOB) + reGOB.
  18.  - BM, FME and WAX file viewers
  19.  - BM -> BMP and BMP -> BM converters
  20.  - a full featured multi-layer, multi-selection level and objects editor.
  21.  
  22. For those who used v 0.90, see history.doc for modifications and search for the
  23. [NEW] keyword in all the doc files.
  24.  
  25.  
  26. WHAT DO YOU NEED TO RUN DFUSE ?
  27. ===============================
  28.  
  29. First of all, a graphic card handling at least 640x480x256 and supported by a
  30. BGI. All VESA cards are ok, so this shouldn't be a big problem.
  31.  
  32. Second, a mouse!
  33.  
  34. As I use the "deltree" DOS command, I think you need MSDOS 6.0 or above.
  35.  
  36. The basic configuration for playing Dark Forces is great, with a little
  37. addition: the use a disk cache (such as Microsoft's SMARTDRV) will greatly
  38. improve the performances of the editor. You should be able to use a small cache
  39. and still launch DF succesfully. Also try to maximize the free conventional
  40. memory as these programs aren't DOS extended, and some levels are HUGE.
  41. As DFUSE will stay in memory when you launch DF, it is overlaid on disk.
  42. The level editor (LEVMAP.EXE) is overlaid to use XMS as buffer (around 200K).
  43.  
  44. In addition to this, you may need a lot of disk space to extract the GOB files.
  45. DFUSE will only extract the levels you work on however so you can control the
  46. disk space used. You don't need to extract textures, frames or sprites to use
  47. the viewers integrated in the editor.
  48.  
  49. What you also need is a text editor that accept filenames on the command line
  50. and if possible a pager (or a text editor accepting BIG files).
  51. You may also use 'PAGE=PAGER.BAT %s' if you don't find a pager.
  52.  
  53. Note: EDIT needs too much memory (460+K) to be used in the level editor, so
  54. try to find something else or take the habit of editing .INF and .GOL in DFUSE
  55. (ie out of the level editor). It is much more annoying for the .O files !
  56.  
  57. A VOC file player and a VOC -> WAV converters are also supported, but these are
  58. far from mandatory.
  59.  
  60.  
  61. COMPATIBILITY & KNOWN PROBLEMS
  62. ==============================
  63.  
  64. The programs run correctly under OS/2 and Windows, but Windows seems sometimes
  65. unable to restore the screen properly when switching back to the programs.
  66. In that case, type 'Z' to get a DOS shell, then 'exit'.
  67.  
  68. During the tests I made, I also tried them on 4DOS. They run perfectly well
  69. if you follow the following rules:
  70.  - do not ALIAS "dir" ,"type", "del", "deltree", "more" or "sort".
  71.    If you do this make a .bat/alias to unalias them, launch dfuse, and realias.
  72.  - file overwrite/redirection must be set to minimum protection
  73.    (see your 4DOS manuals) or 4DOS will systematically ask for a confirmation,
  74.    and some of the messages won't be visible in graphic mode. If you seem to
  75.    be stuck try pressing 'y'.
  76.  
  77.  
  78. INSTALLATION 
  79. ============
  80.  
  81. There is no install program at this time, so you'll have to follow these steps
  82. very carefully (it won't take more than 2 minutes if all is ok):
  83.  
  84. [- type 'DFUSExxx.exe -d'  DO NOT FORGET the -d option !!]
  85.  - edit the file DFUSE.INI
  86.     * set the correct path to your installed game directory (normally c:\dark)
  87.       under the [INSTALLED] header.
  88.     * setup your tools under the [TOOLS] header.
  89.     * setup graphics under the [BGI] header (try VESA and 257 or 259 first).
  90.  - save the file
  91.  
  92.  - type 'DFUSE'
  93.     if   the graphics are ok continue
  94.     else edit DFUSE.INI and try other MODES or BGI
  95.  - go to Levels Menu   (L)
  96.  - select Choose level (C)
  97.  - choose 'SECBASE'
  98.  - select MAP          (M)
  99.  
  100.  - if all is correct, you should see a little (c) message, then progress bars,
  101.    then the map of the first level!
  102.    Else, there is a problem :
  103.     * are you sure you extracted with -d option ?
  104.     * are you sure of the [INSTALLED] path ?
  105.  
  106.  - press the 'i' key to edit the .INF file.
  107.     if   your editor opens up memory is ok, close the file and continue
  108.     else try pressing 'z' to get a DOS shell
  109.       if it opens ok, it is your editor that is too big
  110.          you may try another text editor using less memory
  111.       else
  112.          you will need to gain some conventionnal memory (see your DOS manuals)
  113.       (HINT: when in the level editor, see free memory with Alt + C)
  114. [- if you got a DOS shell, type 'exit' ]
  115.  
  116.  - press the escape key until you are back at the DOS prompt
  117.  
  118. Installation is complete!
  119.  
  120.  
  121.  - read the dfuse.doc, levmap.doc (and levkeys.doc) and the df_specs.doc files
  122.    in the DOC directory
  123.  - play with the editor, try the demos (and read their docs)
  124.  - learn it, love it, hate it...
  125.  - ... but make beautiful levels and put them on the net !
  126.  - don't forget to try a 800x600+ mode for the map editor in DFUSE.INI
  127.  
  128.  
  129. Yves BORCKMANS (yborckmans@abcomp.be (work))
  130.  
  131. NOTES:
  132. The package version has nothing to do with the individual executable versions,
  133. which are for my own version management.
  134.  
  135. Please state the package version when you email me.
  136.  
  137. A friend of mine did make an 'install' on the compuserve 0.90 upload, and that
  138. one handles the -d option. You still have to configure the DFUSE.INI file.
  139.  
  140. ERRATUM:
  141. I said in the comments of the DE1M1-D!  INF file that the level crashes on a
  142. certain operation. I cannot reproduce the error at packaging time, so you may
  143. most probably forget about it. Else, let me know!
  144.